home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / wildcat / jmsts20.zip / JMSTATS.DOC < prev    next >
Text File  |  1993-02-06  |  42KB  |  1,123 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                                   JMSTATS!  ver 2.0
  8.                            for Wildcat! BBS systems
  9.  
  10.                            written by Joe Martin
  11.                                copyright 1992
  12.  
  13.  
  14.             JMSTATS is a complete analyzer of the  Activity logs that are
  15.        produced by Wildcat!. This one program will read the activity logs
  16.        created by either version 3.55 or 2.55 depending on the command line
  17.        you use and store that information for use in later displays.  If
  18.        you have tried to review your activity log file like I have, you
  19.        have probably found that it is great if you are looking at one
  20.        specific thing at a time, but useless if you are interested in
  21.        getting any kind of analysis of what is happening on the BBS on a
  22.        long term basis.  The activity log files take up a lot of room, and
  23.        with a single line or more for each activity, a very active person
  24.        can take up multiple screens of information in a single call.
  25.             Well, no more will you have to settle for this. JMSTATS will
  26.        read these activity logs and compile them into output files that can
  27.        be looked at and interpreted at a glance. This program has been
  28.        designed to be efficient and easily configurable by the sysop to
  29.        meet his needs.  Since each Wildcat!  BBS is distinctive, so should
  30.        the program that analyzes the BBS be.  No need to settle for a
  31.        predefined display that only gives you part of what you need.
  32.             This program was conceived by a need I had of trying to
  33.        determine what was happening on my board over a period of time. I
  34.        have incorporated as many features as I could think of and will add
  35.        more if there is a need.  Now, by looking at a couple of displays, a
  36.        sysop can get a really good feel of what is happening on their
  37.        board.
  38.  
  39.             JMSTATS is written in Turbo Pascal and is designed to be very
  40.        fast.  There is the capability of having multiple configuration
  41.        files so that the data can be collected and output in various
  42.        manners. I will try to go through all the ideas that I would like
  43.        this program to do as it progresses, and I am anxious to hear from
  44.        others whether it fits their needs or if there are some other things
  45.        that I can accomplish with the program. The final outcome of this
  46.        program will depend on what YOU, the sysops, would like to see it
  47.        become. I have added in everything I can think of, but I am sure
  48.        there are others with even better ideas.
  49.             That about covers the general scope and ideals of the program,
  50.        now I will get on to some of the features and uses of the program.
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.                                        1
  66.  
  67.  
  68.                                 JMSTATS ver 2.0
  69.  
  70.  
  71.  
  72.  
  73.                                  DISCLAIMER
  74.  
  75.            This software is provided without any guarantee, either
  76.        expressed or implied.  All responsibilities for its use rest with
  77.        the user of the software and not the author.
  78.  
  79.            JMSTATS software and this document are (C) Copyright 1993
  80.        by Joe Martin.  All rights reserved World Wide.
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.                                        2
  132.  
  133.  
  134.                                 JMSTATS ver 2.0
  135.  
  136.  
  137.                                       LICENSE
  138.  
  139.            JMSTATS is not in the Public Domain.  JMSTATS is not free.
  140.        Non-registered users are granted a limited, 30-day license to
  141.        determine whether or not the program meets their needs.  Continued
  142.        use of JMSTATS beyond the 30-day evaluation time period requires
  143.        registration of the program.  Use of non-registered copies of
  144.        JMSTATS beyond the original evaluation period is strictly
  145.        prohibited.  No one may modify JMSTATS for any reason, in any way,
  146.        including but not limited to decompiling-compiling, patching,
  147.        disassembling, or reverse engineering the program.  JMSTATS may be
  148.        copied and distributed to others, subject to the above restrictions
  149.        and the following:
  150.  
  151.              * JMSTATS must be copied in unmodified form, including the
  152.                file containing this license information.
  153.              * Complete JMSTATS documentation must be included.
  154.              * No copying fee of any type may be assessed other than basic
  155.                charges for the cost of the copying medium.
  156.              * JMSTATS may not be distributed with any other software or
  157.                hardware product(s) without the express written permission
  158.                of Joe Martin.
  159.  
  160.            Sysops (bulletin board SYStem OPerators) may make JMSTATS
  161.        available for downloading by their users as long as all above
  162.        conditions are met.
  163.  
  164.            Commercial Distributors of Public Domain, ShareWare, or User
  165.        Supported software may distribute JMSTATS subject to the above
  166.        conditions only after obtaining specific written permission from Joe
  167.        Martin and filling out a registration form for upgrade
  168.        notifications.  This condition supersedes any and all previous
  169.        agreements.
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.                                        3
  198.  
  199.  
  200.                                 JMSTATS ver 2.0
  201.  
  202.  
  203.  
  204.                                     FEATURES
  205.  
  206.  
  207.           Program operation is handled by using configuration files to set
  208.        up the program to fit the needs of your BBS.
  209.  
  210.           Multiple configuration files that allow you to display the data
  211.        differently or store it in different areas. These multiple
  212.        configuration files can be used to read the activity log files from
  213.        different nodes on a multi-node BBS. They can also be used to store
  214.        the data in different directories for providing different criteria
  215.        such as different length of time to keep the data. For example, you
  216.        may have a subdirectory called WEEKLY and one called MONTHLY and
  217.        each can store the data for the previous week or month. This way,
  218.        you can tell if things are changing on the board and where your
  219.        board is improving or lacking.
  220.  
  221.           Configuration of multiple baud rates to be used in the DOWNLOAD
  222.        display file. The configuration will accept up to 8 baud rates, but
  223.        4 is recommended if you plan on using this file for display on a BBS
  224.        or on your screen. You can choose the most popular baud rates on
  225.        your BBS, whether you have high speed modems or not.
  226.  
  227.           Configuration of multiple file transfer protocols to be used in
  228.        the DOWNLOAD display file. The configuration file will allow you to
  229.        enter up to 10 transfer protocols and will include all others not
  230.        entered in a general grouping called OTHER PROTOCOLS. If you are
  231.        using this file for display on a BBS or on a screen and wish to keep
  232.        it to a single screen, then I would recommend including only 5
  233.        transfer protocols and letting the rest be included in the OTHER
  234.        PROTOCOLS.
  235.  
  236.           Command line switch to not display MNP connections. This would be
  237.        very useful for those sysops who do not have an error-correcting
  238.        modem and thus would never have any use for display connections with
  239.        MNP.
  240.  
  241.           Configuration of Minimum and Maximum transfer CPS to prevent the
  242.        DOWNLOAD display from using erroneous figures in calculating the
  243.        average cps for a protocol or as the minimum or maximum cps in the
  244.        display.  These are entered as a percentage of the optimum transfer
  245.        rate. For example, at 2400 baud, the optimum as determined by most
  246.        terminal and BBS programs would be 240 cps. If you use a minimum
  247.        percentage of 50, the program will calculate the minimum cps to
  248.        accept as 50% of 240 cps which would be 120 cps. The same is true
  249.        for the maximum percentage. If you configure it for a maximum of
  250.        150, at 2400 baud it would be 150% of 240 which would be 360 cps.
  251.        Between these two figures, you can set the limits as to what is
  252.        included in the DOWNLOAD display file.
  253.  
  254.           Display file output can be automatically configured to go to the
  255.        screen by leaving the output path and filename as BLANK.  It can
  256.        also be directed to the printer by entering "PRN" as the output file
  257.        name. This can be very handy if you want to have one configuration
  258.        that includes all of your file transfer protocols or bauds and you
  259.        have a printer that can handle the size of the report.
  260.  
  261.           Exclude files for certain routines to allow the sysop to exclude
  262.        certain file areas or security levels from showing up. This would
  263.                                        4
  264.  
  265.  
  266.                                 JMSTATS ver 2.0
  267.  
  268.        prevent a display from showing areas or filenames that some sysops
  269.        do not want displayed to the general caller, but may want to display
  270.        when he looks at it.
  271.  
  272.           A display file that shows the various activity levels by the
  273.        security level of the callers. This will let a sysop determine how
  274.        good or bad certain security levels are. For example, are your
  275.        callers with a visiting sysop security level spending more time
  276.        downloading files than your subscribing members?
  277.  
  278.           A display file showing various activities sorted by the hour of
  279.        the day. This display can be very useful in determining what is
  280.        being used most on your board during certain times of the day.
  281.  
  282.           There is also a Door Game usage display that will show the number
  283.        of times a door is entered, how much time has been spent in the door
  284.        and also the average time spent in the door. This display can be
  285.        sorted by any of the above fields.
  286.  
  287.           A file download history display that will allow you to enter a
  288.        filename and get a listing of everyone who has downloaded that
  289.        particular file. This is one of the best features of the program in
  290.        my judgement. A couple of uses for this would be to either notify
  291.        all users that have downloaded a particular file in the event you
  292.        found that the file was corrupted or had a virus in it or maybe to
  293.        get a listing of all the callers that have downloaded your
  294.        registration form.
  295.  
  296.           A caller display that will give you loads of pertinent
  297.        information about a particular caller. It will display the number of
  298.        calls, uploads, downloads, fast logins, pages and so on. In
  299.        addition, it will list the name of every file that person has
  300.        uploaded and also a list of every file that they have downloaded.
  301.        This way you can get a good, overall picture of what a particular
  302.        caller has been doing with their on-line time.
  303.  
  304.           Colors are being used by some of the displays and the actual
  305.        colors are stored in a separate file. This file can be set up using
  306.        either the WildCat! @ codes or can contain ANSI codes, whichever the
  307.        sysop prefers. I have included a sample DISPLAY.CLR file with the
  308.        program as an example. If you do not wish to use color codes, either
  309.        change the file or remove it.
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.                                        5
  330.  
  331.  
  332.                                 JMSTATS ver 2.0
  333.  
  334.  
  335.  
  336.                                    OPERATION
  337.  
  338.  
  339.             I would suggest creating a directory called something similar
  340.        to JMSTATS so that you can keep all the files together. Unzip this
  341.        file and put all of the files into this directory that were created
  342.        from the ZIP file.  Then type in JMSTAT -CFG in order to change the
  343.        JMSTAT.CFG file to match the setup needed for operation on your
  344.        board.  You can also change the name of the config file in order to
  345.        create multiple configurations.  Do this for each configuration that
  346.        you will need to use. I have included an example config (JMSTAT.CFG)
  347.        in this archive.
  348.             I have also included some sample output files (those with names
  349.        ending in .BBS and .CLR) for you to see what the displays will look
  350.        like.
  351.             This program can be run either by using switches on the command
  352.        line after the name of the program or by just keying in JMSTAT to
  353.        bring up a menu.  If you wish to use a configuration file other than
  354.        "JMSTAT.CFG", you must include it as a parameter before the parameters
  355.        that will be using that configuration file.  If the name of the
  356.        configuration file is left off, the system will automatically use the
  357.        JMSTAT.CFG file. If the configuration file is not found, the program
  358.        will error out.
  359.             All other switches must be preceded by the '-' in order for the
  360.        program to read them. Some switches will have only one letter while
  361.        others can include other needed information immediately following
  362.        the '-' or even multiple switches in a single parameter for passing
  363.        such things as sorting options or dates.  A listing of the valid
  364.        switches is as follows:
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.                                        6
  396.  
  397.  
  398.                                 JMSTATS ver 2.0
  399.  
  400.                                 SWITCHES
  401.  
  402.  
  403.  
  404.        (note...optional paramters are enclosed in square brackets.)
  405.        (-days is an option that could either be a starting date, a number of
  406.        days prior to today or the letter M which would be just the current
  407.        month's information).
  408.  
  409.  
  410.  
  411.  
  412.        -A[-days].....This switch will create a display file of both your
  413.                 file areas and message areas and shows you how many times
  414.                 files have been downloaded from certain file areas and how
  415.                 many messages are left in certain message areas.  This file
  416.                 is automatically sorted by usage so it is easy to determine
  417.                 what areas of your board are the most popular. The current
  418.                 maximum is 3000 file areas and/or 3000 message areas. The
  419.                 optional days can be added to the command in order to limit
  420.                 the display to a certain time period.
  421.  
  422.  
  423.        -C-callername[-days].....This switch followed by a caller's name will
  424.                 create a display file for an individual caller.  The program
  425.                 will locate the first caller that matches what you have
  426.                 entered, so you must include enough so that it will display
  427.                 the proper caller. If you need to include a space in the
  428.                 caller's name to
  429.                 narrow it down, this can be done by replacing the space with
  430.                 an underscore '_' character on the command line. The program
  431.                 will automatically convert this to a space. It will display
  432.                 the general stats for that caller including such things as
  433.                 number of calls, number of doors, time spent in doors, number
  434.                 of uploads, number and name of all files that this caller has
  435.                 uploaded and downloaded, plus many other statistics relating
  436.                 to that caller. What would you like to have included in this?
  437.                 The -days option can be added to limit the display to a
  438.                 certain time period.
  439.  
  440.  
  441.        -D[-days-NO] .....This switch tells the program to create the
  442.                 DOWNLOAD display file from the data already collected and
  443.                 output it to what is set up in the config file. The 'NO'
  444.                 part tells the program to not print any MNP lines. This is
  445.                 especially useful for those with non error-correcting
  446.                 modems and will allow for twice as many protocols on the
  447.                 screen. The days command can be added in order to limit the
  448.                 display to a certain time period.
  449.  
  450.  
  451.        -F-filename[-days] .....This switch will produce a report of everyone
  452.                 who has downloaded a particular file and when. You must
  453.                 include the filename immediately following the -F. This can be
  454.                 particularly useful if for example you find out that one of
  455.                 your files contains a new virus that was not picked up during
  456.                 an initial virus scan. It will make it very simple to find out
  457.                 who has downloaded this file and notify them. Now that is what
  458.                 I would call a conscientious sysop. The days command can be
  459.                 added in order to limit the display to a certain time period.
  460.  
  461.                                        7
  462.  
  463.  
  464.                                 JMSTATS ver 2.0
  465.  
  466.  
  467.        -G[-days-xx] ....This switch will produce a display of the door game
  468.                   statistics. It will include the door numbers, times entered,
  469.                   total and average time spent in each door game. This will
  470.                   help you in determining which doors are most popular and
  471.                   which may need to be removed due to lack of use. The current
  472.                   limit for # of doors is 29. The 'xx' stands for an
  473.                   additional sort parameter. The options for xx are as
  474.                   follows:
  475.  
  476.                 U ...sort by times Used
  477.                 A ...sort by average time in door
  478.                 T ...sort by total time in door
  479.  
  480.  
  481.        -H  .....This switch will bring up a short listing of the command
  482.                 options that are available.
  483.  
  484.  
  485.        -O[-days] .....This switch will reorganize the database files.  The JDM
  486.                 files must first be sorted using any text file sorting program
  487.                 you wish. I find that QSORT by Ben Baker to do these sorts
  488.                 extremely fast. This switch will remove any duplicate lines
  489.                 from the database files.  This will only need to be used if
  490.                 for some reason you read the same activity log more than one
  491.                 time, or if the database files get messed up with a bad date
  492.                 on the system or something like that.  The days command may be
  493.                 used to clear out all entries older than a certain date.
  494.  
  495.  
  496.        -R[-xxx] .....This tells the program to read the activity log file that
  497.                 you have set up in the config file and add the information
  498.                 into the database files.  That is all the program will do with
  499.                 that switch and will produce no output at that point. For
  500.                 those sysops who are using Tomcat! for NetMail and do not wish
  501.                 the messages uploaded by these netsysops to be included in
  502.                 your message information, you can exclude up to 20 security
  503.                 levels by putting them in a file called EXCLUDE.NET. This file
  504.                 should contain the exact security levels you do not wish to be
  505.                 included in the message statistics (including capitalization).
  506.                 The program will check for the existence of this file and will
  507.                 build all other statistics except the messages database for
  508.                 these callers. The optional field (xxx) will accept the value
  509.                 '255' and will then be able to read the activity logs created
  510.                 by WildCat! version 2.55. This currently has limited support
  511.                 because I have only had one activity log file to look at from
  512.                 that release.
  513.  
  514.  
  515.  
  516.        -S[-days-xx] .....This switch tells the program to create the SECURITY
  517.                 display file from the data already collected and output it to
  518.                 that is set up in the config file. The current limit of # of
  519.                 security levels is 29. The xx part is optional and will
  520.                 determine the sorting of the security display file. xx may
  521.                 consist of the following:
  522.  
  523.                 DL ...sort by number of downloads
  524.                 UL ...sort by number of uploads
  525.                 FL ...sort by number of Fast Logins
  526.                 NF ...sort by number of New file scans
  527.                                        8
  528.  
  529.  
  530.                                 JMSTATS ver 2.0
  531.  
  532.                 TU ...sort by number of Tomcat Uploads
  533.                 TD ...sort by number of Tomcat Downloads
  534.                 P  ...sort by number of sysop Pages
  535.                 M  ...sort by number of Messages
  536.                 G  ...sort by number of door Games entered
  537.                 TC ...sort by number of total calls
  538.                 AV ...sort by Average time per call
  539.                 TM ...sort by Total Minutes
  540.  
  541.  
  542.                 There is also an additional feature of this display and
  543.                 that is the ability to EXCLUDE certain security levels from
  544.                 your display. To do this, create a file called EXCLUDE.SEC
  545.                 in the directory that you are running the JMSTATS program
  546.                 from. Each line of this file would be a security level
  547.                 exactly as it appears in your Activity log. This includes
  548.                 capital letters. Any security level found in this file will
  549.                 not be reported by the security display file. I have
  550.                 included an example of a EXCLUDE.SEC file you to see how it
  551.                 is set up.
  552.  
  553.  
  554.        -T[-days] .....This switch tells the program to create the Time of Day
  555.                 display file. This is a complete display by the hour of the
  556.                 day that will tell you what happened each hour. This includes
  557.                 # of calls, messages, doors, uploads, downloads, pages, etc.
  558.                 The output will be directed to what is set up in the Config
  559.                 file. The optional days command will limit the display to a
  560.                 certain time period.
  561.  
  562.  
  563.        -TF[-days-exclude.fil] .....This switch will produce a top 45 download
  564.                 file listing. In addition, it will allow you the ability via
  565.                 an external EXCLUDE file to not print statistics for certain
  566.                 file areas.  This could be especially useful if you have Adult
  567.                 file areas on the board and do not wish to include them in
  568.                 your top files listing. The default file name that should
  569.                 contain the number of the file areas to exclude is
  570.                 EXCLUDE.FIL. A different filename can be specified on the
  571.                 command line in place of the exclude.fil file. The program
  572.                 currently allows up to 30 file areas to be excluded by putting
  573.                 the file area numbers into the EXCLUDE.FIL using one file area
  574.                 per line. An example EXCLUDE.FIL is included in this package.
  575.                 Be sure to review it and either delete it or change it to fit
  576.                 the needs of your BBS. The days command can be used to limit
  577.                 the display to a certain time period.
  578.  
  579.  
  580.        -TC[-days] .....This switch will create a display file that will show
  581.                 the top 15 callers. There are 3 columns, one for the top
  582.                 caller, one for the top message poster and one for the top
  583.                 uploader. Each column is separate so they can contain
  584.                 different caller names. The days command can be added to limit
  585.                 the display to a certain time period.
  586.  
  587.  
  588.        -TD[-days] .....This switch will create a display file that will show
  589.                 up to 45 callers sorted by the number of files they have
  590.                 downloaded. This can give you an idea of who your main file
  591.                 grabbers are. The days command can be added to limit the
  592.                 display to a certain time period.
  593.                                        9
  594.  
  595.  
  596.                                 JMSTATS ver 2.0
  597.  
  598.  
  599.  
  600.        -CFG .....This switch will allow you to create or modify the
  601.                 configuration files used by the JMSTATS program. All fields
  602.                 are accessible using this command to make it easy to install
  603.                 the program for the first time.
  604.  
  605.  
  606.  
  607.             If you wish to change to a different configuration file within the
  608.        program, just put the name of the new configuration file on the command
  609.        line and all parameters after that will use this new configuration
  610.        file. Unlimited number of configurations can be set up to be used.
  611.  
  612.  
  613.             These switches may be combined on one command line and will be
  614.        performed in the order that they are entered.  Multiple switches can
  615.        and are recommended to be included on the command line. Below are some
  616.        examples of how to use this command line operation to achieve the
  617.        desired results.
  618.  
  619.  
  620.  
  621.  
  622.  
  623.  
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.                                       10
  660.  
  661.  
  662.                                 JMSTATS ver 2.0
  663.  
  664.  
  665.                               SAMPLES
  666.  
  667.  
  668.  
  669.             Let's assume that you are running a single line Wildcat!  BBS
  670.        and wish to use only the DOWNLOAD display file as bulletin #1 on
  671.        your board. First, make sure you have the JMSTAT.CFG file set up to
  672.        match the paths and needs of your system. Let us also assume that
  673.        you will be running this program in your nightly event batch
  674.        program. This is the way you would use the program.
  675.  
  676.  
  677.        NIGHTLY.BAT
  678.  
  679.        CD \JMSTATS
  680.        JMSTAT JMSTAT.CFG -R -D
  681.  
  682.        (this could also be written as follows)
  683.        JMSTAT -R -D
  684.        (since the config file name of JMSTAT.CFG is the default)
  685.  
  686.             That is all that is needed to run on a single line system. If
  687.        you would also like to have it prepare the SECURITY display file,
  688.        but just keep it in the JMSTATS directory for your own use, then be
  689.        sure to set the path correctly in the config file and use the
  690.        following command.
  691.  
  692.        CD \JMSTATS
  693.        JMSTAT JMSTAT.CFG -R -D -S
  694.  
  695.             The -r will build the database from your activity log file. The
  696.        -d will build the DOWNLOAD display file based on the information
  697.        calculated with the first -r switch. The -s switch will build the
  698.        SECURITY display file in a similar manner.
  699.  
  700.             Starting with version 2.0 of JMSTATS, there is no longer a need to
  701.        remove your activity logs once they have been read by the program. The
  702.        files called LASTLINE.??? (where the ??? is the same as the extension
  703.        of the activity log that you are reading into the database) contains
  704.        the date and time of the last entry. Therefore, the -r option will
  705.        start to read the data following this date and time. If you ever have a
  706.        need to actually reread the same activity log file, just delete the
  707.        LASTLINE.??? file for the log you wish to read in.
  708.  
  709.  
  710.             For a multi line system that has more than one activity log but
  711.        the sysop wishes to include the data from all nodes into the
  712.        database files that the reports are built from, then you will have
  713.        to make separate config files for each node.  Since the config file
  714.        includes the full file name that it will read in to include, you
  715.        would have to have something like JMSTAT1.CFG to read in node 1,
  716.        JMSTAT2.CFG to read in node 2, and so on. Then, your nightly batch
  717.        file to read the data from both nodes and combine them into one
  718.        database and prepare both the DOWNLOAD and SECURITY files would look
  719.        like this:
  720.  
  721.        NIGHTLY.BAT
  722.  
  723.        CD \JMSTATS
  724.        JMSTAT JMSTAT1.CFG -R
  725.                                       11
  726.  
  727.  
  728.                                 JMSTATS ver 2.0
  729.  
  730.        JMSTAT JMSTAT2.CFG -R -D -S
  731.  
  732.        or with version 2.0 and above, you could do the following:
  733.  
  734.        CD \JMSTATS
  735.        JMSTAT JMSTAT1.CFG -R JMSTAT2.CFG -R -D -S
  736.  
  737.        since multiple configuration files on one command line are now allowed.
  738.  
  739.             The first time the program is called, it only reads the
  740.        information from the activity log for node 1 into the database. The
  741.        second time the program is called, it reads in the information from
  742.        the activity log for node 2, then it processes and creates the
  743.        DOWNLOAD and SECURITY display files. For more than 2 nodes, you
  744.        would just run the program once for each node using just the -r
  745.        switch but include the -d and -s switches when running the program
  746.        on the last node to be included.
  747.  
  748.  
  749.             To clear the database files, you would first use the -r switch
  750.        to read in the latest data. Then you would use a sorting program
  751.        like QSORT by Ben Baker or any other that you prefer, then use the
  752.        -o switch to clean up the database files. To clear out old records,
  753.        include a date or a number of days after the -o. Here is an example
  754.        of how this would work.
  755.  
  756.        CD \JMSTATS
  757.        JMSTAT JMSTAT.CFG -R
  758.        QSORT CALLS.JDM
  759.        QSORT MESSAGES.JDM
  760.        QSORT DOWNLOADS.JDM
  761.        QSORT UPLOADS.JDM
  762.        QSORT DOORS.JDM
  763.        JMSTAT JMSTAT.CFG -O-11/01/92
  764.  
  765.  
  766.             This first reads in the new data, then the Qsort program sorts
  767.        each of the database files, then the last line deletes any duplicate
  768.        lines and also removes any entries prior to Nov 1st, 1992.
  769.  
  770.             The file that is used to provide the color codes to the program
  771.        is called DISPLAY.CLR. If this file exists, the system will use it
  772.        to enhance the output display files. The format for it is fairly
  773.        simple. Lines 1 and 2 are used for the display heading. Line 3 is
  774.        used for all borders. Lines 4 through 9 are used as column headings
  775.        and the lines from 10 through 15 are used for the actual data. Line
  776.        16 is the code that is printed before the start of the display, and
  777.        can be used to clear the screen or do a nopause. Line 17 is an
  778.        ending code and could be used to pause the screen. Each line should
  779.        contain just one color code.  It could either be a Wildcat!  color
  780.        code or an ANSI color sequence, whichever you prefer.
  781.        There is a sample DISPLAY.CLR file included in this package, so if
  782.        you do not wish to use color, either delete or rename this file.
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.                                       12
  792.  
  793.  
  794.                                 JMSTATS ver 2.0
  795.  
  796.  
  797.  
  798.                                 SUPPORT
  799.  
  800.  
  801.             This program will be supported through ANDROID II BBS, where I
  802.        am the sysop.  The numbers for the BBS are (404) 978-6736 which is a
  803.        2400 baud line and (404) 978-9636 which is a 14,400 v.32bis modem.
  804.        Leave a message to Joe Martin in the JMSTATS support conference. If
  805.        you have an emergency problem, you can try paging the sysop. I am
  806.        also considering setting up a voice support line for registered
  807.        sysops, but that will have to wait until I can find out what kind of
  808.        impact the program will have.
  809.  
  810.  
  811.  
  812.  
  813.  
  814.  
  815.  
  816.  
  817.  
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824.  
  825.  
  826.  
  827.  
  828.  
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.  
  856.  
  857.                                       13
  858.  
  859.  
  860.                                 JMSTATS ver 2.0
  861.  
  862.  
  863.  
  864.                                  DATABASE FILES
  865.  
  866.  
  867.  
  868.                 For those that may find an interest or wish to write their
  869.        own reports from the databases built by JMSTATS, I am including a
  870.        detail summary of the layout of these files. These are the files
  871.        with the extension of JDM.
  872.  
  873.                                        CALLS
  874.  
  875.        position         description
  876.  
  877.        1 - 8         The date of the call.
  878.        9 - 13        The time of the call.
  879.        14 - 16       Amount of time spent on-line.
  880.        17            The type of exit the user made (normal, dropped, etc.)
  881.        18            Whether fast login was used.
  882.        19            Whether a new files scan was done.
  883.        20            Whether the caller uploaded replies using Tomcat!
  884.        21            Whether the caller downloaded messages using Tomcat!
  885.        22            Whether the caller paged the sysop.
  886.        23 - 42       Caller's name.
  887.        43 - 52       Caller's security level.
  888.  
  889.  
  890.                                       UPLOADS
  891.  
  892.        position         description
  893.  
  894.        1 - 8         The date of the call.
  895.        9 - 13        The time of the call.
  896.        14 - 18       Baud rate of the call.
  897.        19            Whether the connection was MNP.
  898.        20 - 31       The filename of the upload.
  899.        32 - 41       The protocol used to upload the file.
  900.        42 - 44       The file area that it was uploaded to.
  901.        45 - 64       Caller's name.
  902.        65 - 74       Caller's security level.
  903.  
  904.  
  905.                                      DOWNLOADS
  906.  
  907.        position         description
  908.  
  909.        1 - 8         The date of the call.
  910.        9 - 13        The time of the call.
  911.        14 - 18       The baud rat of the call.
  912.        19            Whether the connection was MNP.
  913.        20 - 23       The CPS of the transfer.
  914.        24 - 35       The filename of the download.
  915.        36 - 45       The protocol used for the transfer.
  916.        46 - 48       The file area downloaded from.
  917.        49 - 68       Caller's name.
  918.        69 - 77       Caller's security level.
  919.  
  920.  
  921.  
  922.  
  923.                                       14
  924.  
  925.  
  926.                                 JMSTATS ver 2.0
  927.  
  928.                                      MESSAGES
  929.  
  930.        position         description
  931.  
  932.        1 - 8         The date of the call.
  933.        9 - 13        The time of the call.
  934.        14 - 17       The message area the the message was entered in.
  935.        18 - 37       Caller's name.
  936.        38 - 47       Caller's security level.
  937.  
  938.  
  939.                                        DOORS
  940.  
  941.        position         description
  942.  
  943.        1 - 8         The date of the call.
  944.        9 - 13        The time of the call.
  945.        14 - 15       Amount of time spent in the door.
  946.        16 - 18       The door number.
  947.        19 - 38       Caller's name.
  948.        39 - 48       Caller's security level.
  949.  
  950.  
  951.  
  952.  
  953.                                     CONFIG FILE
  954.  
  955.  
  956.                 An example of a config file is shown here with
  957.        explanations.
  958.  
  959.  
  960.        C:\JMSTATS\
  961.        C:\WC30\ACTIVITY.001
  962.        C:\JMSTATS\DOWNLOAD.BBS
  963.        1200
  964.        2400
  965.        9600
  966.        14400
  967.  
  968.  
  969.  
  970.  
  971.        Xmodem
  972.        Xmodem/CRC
  973.        Xmodem/1KG
  974.        Ymodem
  975.        Ymodem/G
  976.        Zmodem
  977.        HS-Link
  978.        Moby-Turbo
  979.  
  980.  
  981.        50
  982.        150
  983.        C:\JMSTATS\SECURITY.BBS
  984.        C:\JMSTATS\FILENAME.BBS
  985.        C:\JMSTATS\CALLER.BBS
  986.        C:\JMSTATS\DOORSTAT.BBS
  987.        C:\JMSTATS\TOPFILES.BBS
  988.        C:\JMSTATS\TIMEODAY.BBS
  989.                                       15
  990.  
  991.  
  992.                                 JMSTATS ver 2.0
  993.  
  994.        C:\JMSTATS\AREASTAT.BBS
  995.        C:\JMSTATS\TOPCALLS.BBS
  996.        C:\JMSTATS\TOPDOWN.BBS
  997.  
  998.        --------------------------------------------------------------------
  999.  
  1000.        WARNING!!!!  All lines above this must be there or the program will
  1001.        not run properly if at all.
  1002.  
  1003.        Definition of what the above configuration paramters mean:
  1004.  
  1005.        1...This is the path to where the data files are to be stored. By
  1006.            having multiple configuration files with different directories
  1007.            in this field, you can maintain separate databases for such
  1008.            things as different nodes or different lengths of data
  1009.            retention.
  1010.  
  1011.        2...This is the full path and filename of the ACTIVITY log that you
  1012.            will be reading from. This is where WILDCAT! stores the
  1013.            information this program reads it's information from.
  1014.  
  1015.        3...This is the full path and filename where the DOWNLOADS output
  1016.            display will go. This could either be in the form of a bulletin
  1017.            or Hello file or it could be a file stored somewhere else.
  1018.            Leaving this line blank will force the output to go to the
  1019.            screen, but with no pauses at this time. Putting PRN in this
  1020.            line will send the output to the printer.
  1021.  
  1022.        4-11...These lines are the baud rates that will be displayed on the
  1023.            download display. These must EXACTLY match the baud rates that
  1024.            show up in your activity log. There are 8 lines for these and
  1025.            they will appear in the exact order you enter them in this
  1026.            configuration file.  Normal screen width would allow only 4
  1027.            different baud rates. Of course, you may fill in more if you are
  1028.            storing as a disk file that will not be used as a bulletin or
  1029.            hello screen, or if you are sending the output to a printer that
  1030.            can handle more than 80 characters per line. Leave all other
  1031.            lines as blank lines within these lines so the program will
  1032.            truncate the display properly.
  1033.  
  1034.        12-21...These lines contain the file transfer protocols that will
  1035.            appear in the download output. These must EXACTLY match the way
  1036.            they appear in your activity log file. The output will take any
  1037.            other downloads that do not match these and group them in a
  1038.            protocol called 'OTHER PROTOCOLS' so that they will be included
  1039.            in the display after the ones you have defined. The output will
  1040.            contain these protocols in the exact order that you enter them.
  1041.            In order to fit on a standard single screen, I would recommend
  1042.            only putting in 5 protocols as it will add the OTHER PROTOCOLS
  1043.            to the bottom of the display. Enter your most popular file
  1044.            transfer protocols on these lines. Leave all other lines as
  1045.            blank lines within these lines so the program will truncate the
  1046.            display accordingly.
  1047.  
  1048.        22...This line contains the Minimum percentage of cps that you wish
  1049.            to include in the display and the average cps calculation. For
  1050.            example, if you have this line set at 50, then a file transfer
  1051.            for a 2400 baud caller would only be included if his cps was
  1052.            greater than 120.  This will prevent those occasional file
  1053.            transfers where the caller had a problem either on his end or
  1054.            with the file and will not use these figures.
  1055.                                       16
  1056.  
  1057.  
  1058.                                 JMSTATS ver 2.0
  1059.  
  1060.  
  1061.        23...This line contains the Maximum percentage of cps that you wish
  1062.            to include in the display and the average cps calculation. For
  1063.            example, if you have this line set at 150, then a file transfer
  1064.            for a 2400 baud caller would only be included if his cps was
  1065.            less than 360.  This will prevent those occasional file
  1066.            transfers where the activity log shows some strange figure
  1067.            because of recovery mode on a file transfer from showing up in
  1068.            the display and affecting the average cps.
  1069.  
  1070.        24...This line is the full path and filename of the output file for
  1071.            the Security level display. This can be PRN to output to the
  1072.            printer, or left blank to output to the screen. Like the
  1073.            download display, this can also be used as a bulletin or Hello
  1074.            file.
  1075.  
  1076.        25...This line is the full path and filename of the output file for
  1077.            the Filename display. This can be PRN to output to the printer,
  1078.            or left blank to output to the screen. This option is not
  1079.            intended to be used as a bulletin or hello file.
  1080.  
  1081.        26...This line is the full path and filename of the output file for
  1082.            the caller display. This can be PRN to output to the printer, or
  1083.            left blank to output to the screen. This option is not intended
  1084.            to be used as a bulletin or hello file.
  1085.  
  1086.        27...This line is the full path and filename of the output file for
  1087.            the Door statistics display. This can be PRN to output to the
  1088.            printer, or left blank to output to the screen. This option can
  1089.            be used as a bulletin or Hello screen.
  1090.  
  1091.        28...This line is the full path and filename for the output file for
  1092.            the TOPFILES display. This can be PRN to output to the printer,
  1093.            or left blank to output to the screen. This option can be used
  1094.            as a bulletin or Hello screen.
  1095.  
  1096.        29...This line is the full path and filename for the output file for
  1097.            the Time of Day display. This can be PRN to output to the
  1098.            printer, or left blank to output to the screen. This option can
  1099.            be used as a bulletin or Hello screen.
  1100.  
  1101.        30...This line is the full path and filename for the output file for
  1102.            the file and message area statistics display. This can be PRN to
  1103.            output to the printer, or left blank to output to the screen.
  1104.            This option can be used as a bulletin or Hello screen.
  1105.  
  1106.        31...This line is the full path and filename for the output file for
  1107.            the Top Callers display file. This can be PRN to output to the
  1108.            printer, or left blank to output to the screen. This option is
  1109.            especially useful as a bulletin or Hello screen.
  1110.  
  1111.        32...This line is the full path and filename for the output file for
  1112.            the Top Downloaders display file. This can be PRN to output to the
  1113.            printer. or left blank to output to the screen. This option is
  1114.            especially useful as a bulletin or Hello screen.
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  
  1121.                                       17
  1122.  
  1123.